---
title: Qwik
description: 适用于 Ultracite 的 Qwik 特定 lint 规则。
---

该 Qwik 配置包含针对序列化、可见任务、词法作用域和方法使用的 Qwik 特定 lint 规则。

## 安装

将 Qwik 配置添加到你的 `biome.jsonc`:

```jsonc title="biome.jsonc"
{
  "extends": ["ultracite/core", "ultracite/qwik"]
}
```

## 概览

此配置添加了针对 Qwik 开发的特定规则：

- **序列化**: 强制正确使用 Qwik 的可恢复性模型
- **可见任务**: 防止不当使用 `useVisibleTask$`
- **词法作用域**: 确保在 `$` 函数中变量作用域正确
- **方法使用**: 强制正确的 Qwik 方法使用模式
- **React 特定 Props**: 禁止在 Qwik 组件中使用 React 特定的 props

## Qwik 特定规则

### 正确性

| 规则 | 设置 | 描述 |
|------|---------|-------------|
| `noQwikUseVisibleTask` | `error` | 阻止使用 `useVisibleTask$`。该 Hook 会在客户端急切执行代码，从而破坏 Qwik 的可恢复性。尽可能改用 `useTask$` 或 `useResource$`。 |
| `useQwikClasslist` | `error` | 强制在 Qwik 中对动态类使用 `class` 对象语法，而不是字符串连接。 |

### 孵化

| 规则 | 设置 | 描述 |
|------|---------|-------------|
| `useQwikValidLexicalScope` | `error` | 强制在 Qwik 的 `$` 函数中使用有效的词法作用域。来自外层作用域的变量必须被显式捕获。 |
| `useQwikMethodUsage` | `error` | 强制正确使用 Qwik 特定的方法和 API。 |

### 可疑

| 规则 | 设置 | 描述 |
|------|---------|-------------|
| `noReactSpecificProps` | `error` | 禁止在 Qwik 中使用像 `className` 和 `htmlFor` 这样的 React 特定属性。请改用 `class` 和 `for`。 |